home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / cmenu.arc / CMENU.DOC < prev    next >
Encoding:
Text File  |  1985-01-23  |  3.3 KB  |  62 lines
  1.                                  CMENU
  2.  
  3. CMENU allows various programs to be connected by and called from menus.
  4. The menus are ascii text files which are read by CMENU and control the
  5. display and the program chaining.  CMENU reads the menu and outputs its
  6. characters to the console until it reaches the first '~' ("tilde").
  7. The tilde character is not displayed, but the character string beginning
  8. immediately after it and terminating with a CR is the name of the
  9. program which will be executed if the user enters a '0' or a CR only.
  10. If no characters are present between the tilde and the CR, CMENU will
  11. terminate in response to a 0 entry.  The remaining CR terminated strings 
  12. determine the programs which will be loaded in response to a non-zero entry.
  13. The first string is the name of the program which will be executed if '1' 
  14. is entered; entering '2' will cause the second program to be loaded.  If
  15. any program name string is empty (a line with only a CR) then entering
  16. the selection associated with it will also cause CMENU to terminate.  CMENU
  17. counts the number of program options and will reject an entry which is non-
  18. numeric or out of range.  When the called program has terminated CMENU 
  19. will redisplay its menu.  The CMENU.COM contained in CMENU.LBR permits
  20. up to 51 program selections (0 - 50) with each program string having a
  21. maximum of 80 characters.  The capacity of the program can be changed
  22. by modifying C_SIZE, B_SIZE & MAXPROGS and recompiling.
  23.  
  24. CMENU may reload itself and execute another menu and when it terminates,
  25. the previous menu will be displayed.  This allows you to create a multi-layer
  26. directory scheme.  To run CMENU, enter 'cmenu [menu]'.  If [menu] is not
  27. specified CMENU will immediately terminate.
  28.  
  29. CMENU can pass command line arguments to all programs written in Lattice C.
  30. You may or may not be able to pass arguments to other programs.  If you try
  31. it may work, but you might have to do things a little differently than you
  32. would from DOS.  For instance the Prokey command line 'prokey ws.pro/r'
  33. works from DOS but not from CMENU; however 'prokey /r ws.pro' works from
  34. both.
  35.  
  36. If a program is not present in the current directory, CMENU will search
  37. for it through the PATH directories.  There are two peculiarities.  First
  38. if the root directory is to be searched it must be designated as '[DRIVE]:'
  39. rather than '[DRIVE]:\'.  All other directory specifications work as usual.
  40. Therefore if you want to access the root directory with both CMENU and DOS
  41. commands the PATH environment should include both values ( 'PATH C:\;C:' ).
  42. Second, only the first menu level has access to the PATH environment that
  43. is set from DOS.  However, CMENU will accept a path specification as
  44. part of the program name and will find the program if it is in that
  45. directory.
  46.  
  47. CMENU.LBR contains the following files:
  48.  
  49.     CMENU.COM    Program file.
  50.     CMENU.C        CMENU source code.
  51.     CMENU.DOC    This documentation file.
  52.     MENU00.MNU    Sample menu file, using ansi escape sequence.
  53.     MENU01.MNU    Sample menu file, without ansi escape sequence.
  54.     EPSON.EXE    Lattice C program to set up Epson Printers. The
  55.             program is self documenting if you enter 'epson'.
  56.     DEMO.BAT    Demonstration batch file.
  57.  
  58.  
  59.  
  60. Welcom H. Watson, Jr.
  61. January 21, 1985
  62.